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This Nemo* describes two small utility programs that are of assistance 
in using the ITS 1.4 tsee A.I. 161, MAC-M-377) time sharing system. 

LOCK perform* miscellaneous utility functions while FEEK displays. 

with periodic updates, various aspects of the time sharing system's status. 
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1 * In troduction 

This neno describes two small utHHy programs that are 
reinvent only to use of the ITS 1*4 time sharia#; system. This 
time sharing system is described, as of June 196 S, in memo 
MAC-M- 37 ? [Ref 21 which Is frequently referee to by this memo* 

The same notattonal schema Is used In this memo as described in 
Section zero of KAC-H- 3 - 7 ? with the addition of the notation (Ref 

i y(, z, for sectioofs) yf, i, ***) in reference i, for 

Sample (Hef Z>Sec OK 

The first program herein discussed, PZEK, provides 
periodically update1 displays of Tarlows aspects of the time 

“i. 

sharin# system s status, The second and saaller program, EjCCK, 
performs a variety of miscellaneous functions, 

Artificial Intelligence Group nemo ai i4?CBef 1.1 is 
extremely reinvent to the usual loading and transfer of control 
to the within described programs, 

w,e that the commands- P, Q, and ? have the same meaning for 
both programs. The 7 command causes each of them to print a List 
of their commands with short explanations. 
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2 , PEEK 

2 A Introduction 

| 

| 

i 

PEEK is a utility program -operatine under ITS [Sef 51* It 
enables a user to monitor a variety of aspects of the time 
sharing system by providing neriodically updated display output 

; 

or periodic character string output to teletype or line printer* 
Commands to PEEK are ein?le lettors sometimes proceeded by 

i 

numeric ar^uiiefite. When initially started, PEEK is in ft* or 
normal* mode TSec 2*21. If the user is on a &K console IHef 
?’3$c 4.5J PE1K will initially start outouting by typing (which, 
on a GS console, Is effectively displaying). If the user Is bn a 
teletype, PEEK will fry to seise the 240 display [Pef 2>Sec 4,111 
and either display on the 240 or type its output depending on 
whether it succeeds or falls, respectively* This may be 
disconcerting tf you are at a teletype not in view of the 240 
because It will appear that the PEEK is just slttij-^ there* This 
can be rectified with the "K command tSec £.5), 

The first line of all pure-s output by F2EE is as follows: 


ITS xjcx 


yyy mm/dd/yy hh:mm;ss 
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where xxx ts the version number of the system in use [Eef 2>$ec 
^,6,3], yyy is the version number of the PEEK in use {so tuf* can 
he matched to exact version), and raa/dd/yy is the date and 
hh:mm;£s the tires accordins to ITS IPef £>£ec 7,.3-,P, 7,3,31, The 
last line of all pa^es displayed on the 340 by PEEK is a list of 
mode coisaands which can be Mven by liphtPennine: [Ref 2>Sec 
7*11 ,£3 them with effects identical to typing them. 

All characters typed at- PEEK &Te interpreted at its 
Interrupt level and base effect, if any, immediately* Characters 
that are not CDBinands T dibits, or *Z are coapleteLy ignored* 
Eiaits are accumulated as an octal number until a nor-diell Is 
typed at which time the accumulated number Is made available (if 
the rton-dUit is a command taking a numeric argument) and reset. 

The anount of memory occupied by PEEC varies with node but 
the present minimum ie three memory blocks (a total of SOQO 
words)* 
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£,£ Wndee Available 

The articular subset of the time sharing system's status 
bein£ output by PEEK is controlled by its mode. Initially EQE 
is in tf mode but it ma.Y be changed to any uf thoee listed below 
by typing tbe letter indicated or llsht penning (Ref £>Sec 
4.11.31 it if FM it display lug on the 340* Unless otherwise 
specified the output repetition rate for these modes Is the 
standard rate Initially set to 5 seconds delay after end of pe^e 
output before starting bn the next update. This is variable by 
the user with the 2 command [See £,41 * 


D This mode outputs 3&ta~di$R directories (Ref Sl^Sec 

4,2], It is norpially proceeded by a drive number* If output is 
being typed* the standard system generated directory is used [Kef 
£>$ec 3*2*11, If output is to the 34C or Line printer* an 
expanded form is used. The lover part of this form is similar to 
the system supplied directory. It hat an additional number after 
the file name and before its length, This number is a pointer to 
the first physical block used by the file (minus one indicates a 
file of length zero}. The upper part of this form is the List 
structure area of the directory vhlch has for each physical block 
either the number of the next block in the file containing it* 
minus one if It is the last block In a file, or zero if it is 
unused, 

G This node lists the sisbit symbols recognized by 

.GJTTSYS (Ref 2>£ec 7,6.ll in the system in use. Output is 
updated after a ten second delay, 

H 


Only available with the 340 display, thle mode 
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a * r ^h "W°ry with different memory users on 
different vertical levels and location represented hy horizontal 
coordinate, 1 

3 Tlie symbolic devices implemented in the sysUw lit 

uae lEaf 2>App 5] are listed by this mode* Output is updated 
after a ten second delay* 

M Tbi-S mode is somewhat reminiscent of H node* It 

lists all memory users and the amount, of menory they are using in 
decreasing order* An is also output by stopped jobs as are 
™ characters for special resources being used by any iob (see 
table below), ' ' 


fl This U the most frequently used mode of FSH, It 

tries to give a snapshot of the status of all user Jobs lu the 
system, Different amounts of Information are displayed depend Id*? 
on the particular output device in use, but in all cases the 
following additional information is output; 


U) Above the list of user jobs, the number of free 
aoc^s. {each 2GOO words) of aemory (WEHfil), the lumber of areas 
that are allocated for user variable [Hof £>App C] (UERKI), and 

(EMABLU) ■ ^ ^ User P ”* I ' ai!]S that v#re rujl bable last schedule time 

^ (2) Balw the list of user jobs, the number of 

blocks o- memory occupied by user programs (Usa HIM) (the sun of 
this figure and VIEHPTi is not constant due to dynamic TO buffers}, 
Uift total rareentags of machine time being used by the listed 
programs (ITSR TIM) (less than one hundred due to scheduling and 

w! r t * 1 j a - ?0U]lt °f that the running system has 

been ',p ■, STI^i), and the total amount of machine time used by 
Users that have lodged out (ifiUTIM), 


J5e tween 
there is one line of 
topped hy a title lin 
of information. The 
procedure will be the 
uniquely refers to it 
either the UftAKE for 
inferiors or the All AM 
depending on tbs line 


the Ua sets of information, described above* 
Irtj orrration for each procedure in the system 
e which provides a heading for each column 
first item or the line for any particular 
user Index of the procedure* a number that 
(see mode v]. The second item will he 
top level procedures and the JKAHS for 
-t and SRAMS for each procedure 

width of the output device. This second 
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Item also portrays the ejristant procedure tree structure in that 
each T<arceiure not at the top level is on inferior of the nearest 
procedure above It who?* name is not indented- as far* 

Other itens include an exponential arproxiEatlon to 
the percentage of machine time the procedure has been receiving, 
the number of core blocks it is occupying,, a colurr Late lei "TTY" 
that has a *T" concatenated with the console number opposite 
■procedures controlling a console, various letters immediately 
after the ir TTT n column for systen resources controled by the 
procedure (free the table below) „ and a C-oIueh labeled "STATUS”* 

The character string opposite a procedure in the STATUS column 
should iie Interpreted as follows; (1) a leading ir#1 ' indicates 

that the procedure is processing a software interrupt (Pef 2>£ec 
5,21 , (2) "HUH" indicates that the program is running in user 
mode, (S) a nair of numbers separated by an "1" indicates that 
the procedure is stopped, (4) most other strings represent a 
system call (with S used for the very comron *SLEEP call) or 
input-output device and type of transfer-; (4A) if preceded by a 
1f +‘ l the procedure is running in executive eode performing the 
call or input-output; (43) if not it is hung on the call or 
input-output, 

T The contents of the system translation table [Ref 

2>$ec 3*31 is output, 

U This mode displays the status cf the DEC tape drives 

[Ref 2>5ec 4.11 and of open PEC tape files. For the normal user, 

the most Useful information per tapa 1? the drive number in the 

leftmost Column and the DIR variable in the next to the rightmost 

{Tjr?AS£) Column* If the DIR variable is minus one, ITS is not 

retaining a directory for that drive and a tape mounted on it 
could be removed manually* Otherwise it is the absolute location 
of the directory. The per onen file information includes the 
names of the procedure usio^ the file, its direction, and the 
number of buffers (200 words each) currently beinc used for the 
file hJr She system* 

V This, mode command should be proceeded by the user 

Index, (see node above) of some user. It displays many Of his 
user variables [Ref 2>Api> tJ and the channel word and status word 
for each of his input-output channels [Ref *>£ec 3,1, 3,eh If 
output is to the 340 or line printer, the contents of the 
selected users accumulators are also output. 
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mo*e outputs the digitalisation of a ij the 
multiplexed analog to digital input channels [Ref 2>£ec 4*£I and 
the value neU* output on each of the multiplexed digital %l 
analog channels [Ref 2*Sec 4.10]* aI tQ 

.. Y t This mode outputs Eastern supplied [fief ?>3er ^ ? n 

™'^!" ES ft,r ^ U,WSi 11 sll “ u *pS“mS 4 fdri4 


m .! « 4e mt r at f a list a »4 urtef emanation of 

HEK r command. * An example is Included In the appendix, Output 
Is undated after - a ten second delaj% 


The fell wine are the systtvt resource letters used in modes 
H and >[ above s 


C Indicates that the procedure is now or was the la*t 

to use the core allocator* 

tVjl that the procedure has setzed control of 

the iLVv 340 display* 


T 

derice* 


Indicates that the procedure has control of the 


03D 


This letter can he present for more than One 

"IM-user" n,»d« lee^a!!? _ prMeAuM 11 »>»« *“1' in 

printer T ndieatea that the procedure hag control of the lino 

H Indicates that the procedure has Placed itself in a 

:?£ 'ss^is^r selie the 345 disrlar ' arl ,s 

P Indicates that the procedure has control of the 
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plotter * 

- K Indicates that the procedure has control of the 

rarer tape reader. 

T Indicates that the procedure has control of the 

paper tare punch. 


J 
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) 


£,3 IQ Control 

win output to only one device at a time, The initial 
device Is chosen a? explained in section 2,1, m of the 
follow*™ four commals for chanyin? PEEK 'a output device also 

cause Pm to Immediately restart output for its current mode 
fSen 2,2]: 


available* 


pits switches output to the line printer if it is J 
If not available the output device will he uncharged, 


.«** 3 , 171113 ^ aMnd vin twminats F3EK output to the line 

printer and cause it to either type or display its output! 

s~ «*«r n rxr 

a' S 3 m “ ,e,,I>tS 10 sfl " th « 5 “ 

„„ 7 F ? H * 111 “tteapt to selje the 340 disMai for 

«U U ™L[ EC t; fI f thl T COI ' : "* ri< ‘ If it is mtaUMesmi, mitwit 

aboie tn ■" SSSe th * flw “ ef -ti»"s<! under "B 








PEEK arid LQCEC 


Fa^e 10 


) 


2,4 Miscellaneous 


The fallowing are miscellaneous F3EK commands: 


? T Jnder normal cipcuastances, this ccmaand will return 

control of the we ere cohtole to TJDT T5ef 11 hut leave ?E?& 
fUnnius and, If the 340 display or line printer Is selected, 
rrodesciny output, 

0 Under nor sal circumstances, this command will 

destroy the PEEK it is tyned at and return control of the users 
console to FET* 

2 This command should be proceeded by a small number* 

It sets the standard update delay to as many seconds [Sec 2.Z1* 

■ This comSiand will probably ^o away when swapping Is 

added to the system, ltndeT normal circumstances it will cause 
the procedure tree In which is found the FEES it is typed at tp 
he replaced by a. single newly loaded FEsK at the top level. This 
saves memory If several people want to leave a PEEK at a single 
console running for their Joint enlightenment. A top level PEEK 
will comait suicide if a is typed at it. 
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3.1 Introduction 

LOCK is a utility program operatinr under ITS Terforalnr a 
multitude of infrequently required tasks, Its nate derives from 
the fact that the function U was originally written for to 
H lodr" and "unlock" teletypes (see the + and - commands tSec 
3.23), Most of EOCK's commands ate sihfle characters. 

In contrast to FEES, which interprets ec-nmands at the 
interrupt level, commands to LOCK are read at its main program 
level. Thus commands will in general have no effect before 
previous commands have been completed. In fact, some commands 
cause a change In the state of LOCK such that following Letter? 
are interpreted as arguments. 

LOCK occupies only a tit block (2000 words) of memory except 
in mode "T. 

3,2 Commands 

The following are the current LOCK commands; 
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■+ This command should be proceeded by a teletype (nr 

GS console) number (Raf £*Sec 4*51, The LOCK will try to open 
t,he ’specified teletype at an input-output device* It will "be 
succesful only if the teletype is not in use, if it ig 
successful, the teletype will become iupervious to "£*6 so no 
user can lop in on it, LOCK will type out an appropriate message 
on the now locked teletype, and LOCK will tyre a "W* to the LtvCK 
user. If the LOCK fails in opening the teletype it will type an 
■1" at the LOCK user* 

* This command should he proceeded by a teletype 

number* If LOCK lias the specified teltyre locked it will unlock 
it and type out an u *'\ Otherwise it will type a 

Thin eo&n&iid should be preceeded hy the octal code 
for a character* LOCK will type out the character represented, 

G This command should ho preceded by the user index 

ESec 2*2, see mode Kl of the top procedure in a tree that the 
user wishes, to obliterate, It must he followed by the characters 
"HR"* If the user deviates from this sequence, a "1" will be 
typed and LOCK will listen for a new command, 

I A series of marie characters must be typed at a 

model 37 teletype to allow its Use in full duple*, the mods 
assumed by most rroprams operating under ITS* This cowand 
causes LOOK to tyr>e the requisite character?♦ 

K This command must he immediately followed by the 

characters p, ILL' r (see G above} and should be preceded by a 
number. It will activate the systom going down feature of ITS 
with a time Unit of five or the number preceedinf the command 
minutes, whichever is larger, 

0 When it receives this commend, LOCK will permanently 

go into a mole where characters typed at it are echoed as there 
ASCII value in octal. To ultimately escape from LOCK in this 
mode, the user should U$e *2* 

F Under normal circumstances, this command causes 

control of a users consols to revert to bis DIiT EEef 11. 

q Under normal circumstances, this command causes 
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Control of a users console to revart to hit LET and Us IOCK 
to destroyed. ‘Sote that this will unlock all teletypes 
previously locked by the destroyed LOCK as destroying 
closes all Its channels, 


to 


a procedure 


£ This conmand cosiflemenU the run status of the 

system checkins feature of the system Job rPef £>Sec ?.5l It 
vui t yp e out the resultant state as either "START" or "STOP", 


T Thie command. causes complex and non terminating 

gyration? on the part of the LOCK It is typed at and the '' 

the LOCK will create as a result of this command, its 
purpose is to test the core allocator CEef 2>Sec 5,3] and other 
components of the ITS system. It? casual use Is not recommended. 


,, * ™ s SOManfl causes LOCK to type out an u-n to date 

-1st of Itt commands with a brief explanation of each," An 
example appear? In the appendix* 
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Append! it* Illtietrative Co os ole Output 

The fan wing pages illustrate the current self 
documentation output of PESK [Sec £3 and I£CX tS* c 3 ) the "r 
node fSec £.2.1 output of PEEK* t, feu m [Kef U commands are 
illustrated In, passing* 
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ITS 444 P£D^ 1£4 1S/VQ/6G 
MODE CONTROL! 

l DISK DIRECTORY (PRECEDE GY HUM) 
G AVA|LAELE ,GETZS'S 
H MEWORTf IJtAPH tlk'i ONLY) 

I AVAILABLE 10 DEVICES 
M MEwOR [ USE LIST 
N NORMAL MODE 
T TRANSLATION ENTRIES 
U DEC TARE STATUS 

V SINGLE USER (PRECEDE BY INDEX) 

X MULTIPLEXORS MODE 

Y DEC TAPE DIRECTORY <"> 

7 EXPLANATION '.HOPE 

10 CONTROL: 
t& use LINE PRINTER 
tE STOP USING LINE PRINTER 
t'r' USE 342 
+N STOP l£|lffi 342 
OTHER! 

P PROCEED 3UT RETURN TTY TO DOT 
? QUI 7 

Z SET DOZE IN SECONDS 
I STAND ALONE 


14i££i4lS ’ 




0 

s*x* 



f££TAAt^v^ ..O 


I 








PilgiS IS 


i LOCK [ 
LOCK.35 
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+ LUCK T7Y (PRECEDE BY #) 

- UNLOCK TTY C") 

- OUTPUT CHAR AC m WITH ASCII VALUE £ O 
GUN KILL USES «l TH £ I HUES C") 

I INlTfALIZE ^ MODEL 37 TTY 

KILL SYSTEM DOWN IN jf MI NOTES O ? 

Q OUTPUT CHARACTERS 1H OCTAL £ 

P RETURN TO DQT 

0 VALRET AN $rx» 

S CDftPLEWENT RUN STATUS QF SYS JOB 
T TEST CORE ALLOCATUR 
7 LIST COMMANDS 


+-Q 

?LOGOUT 

iT$ 444 COTS OLE 3 FREE* 14*2**52 
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